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LiveCode 8.0 brings important new capabilities to all LiveCode developers: 


LiveCode 8.0.2 Release Notes 8/9/16 


e Use newcustom controls and libraries in your applications, including a new browser widget. 
e Extend LiveCode with the new LiveCode Builder language 
e Deploy to HTML5 and run your application in a web browser 


e Many other improvements! 


Simplify design with widgets 


With LiveCode 8.0, your apps are set free from using the small range of user interface controls 
that were previously available in LiveCode. The LiveCode engine now lets you load custom 
controls, called widgets, and use them in your apps just like any other control. 


LiveCode comes with a selection of widgets that simplify creating many commonly-needed sets of 
controls in mobile apps, and if they aren't enough, you can download and install widgets created 
by members of the LiveCode development community and third-party vendors. 


One of the most exciting new widgets introduced in LiveCode 8.0 is the browser widget. It replaces 
the revBrowser external with a much more powerful and flexible browser control that's easier to 
use and more reliable. 


The LiveCode IDE has also been extended and revised in order to support widgets and other 
extensions. Widgets are now available in the "Tools" palette, and installed extensions can be 
viewed in the "Extension Manager". The dictionary has been extended to include extension 
documentation. 


Extend Livecode with LiveCode Builder 


In LiveCode 8.0, the well-known LiveCode scripting language is joined by a brand new 
programming language called LiveCode Builder. LiveCode Builder looks a lot like LiveCode script, 
and should be easy to learn for any experienced LiveCode developer. 


Using LiveCode Builder, it is now possible to extend LiveCode with new controls and libraries 
without any need to program in C or C++. The IDE has a new "Extension Builder" tool that helps 
developers test, debug and package their extensions. 


For more information, please refer to the "Extending LiveCode" guide and the "LiveCode Builder" 
section of the dictionary. 


Note: LiveCode Builder is a new and experimental language. There is no stability guarantee for 
the language or its standard libraries. Be aware that the language syntax or features may change 
incompatibly in future versions of LiveCode! 


Deploy to the browser with HTML5 


The LiveCode 8.0 engine nowruns on a new platform: the web browser. The LiveCode engine now 
runs as a JavaScript library in an HTML page, allowing users to run your application without having 
to install anything. 


For more information, please refer to the "HTML5 Deployment" guide. 
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Note: The HTML5 platform is very different to the other platforms that LiveCode supports, and 
many engine features are either unsupported or work differently. 


More! 
LiveCode 8.0 includes many other enhancements, including: 
e more powerful and complete clipboard access, sponsored by FMProMigrator 


e 64-bit Mac standalone deployment, SSL support for PostgreSQL connections, and "find and 
replace" that preserves text style, all sponsored by the community Feature Exchange 


e optimised Unicode text processing 

e Unicode printing on Linux 

e anewJSON library extension 

e greatly improved native theming on desktop platforms 


e anew IDE Start Center and interactive tutorial 


Known | = 


e The installer will currently fail if you run it from a network share on Windows. Please copy the 
installer to a local disk before launching on this platform. 


e The browser widget does not work on 32-bit Linux. 


e 64-bit standalones for Mac OS X do not have support for audio recording or the 
revVideoGrabber external. 
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The engine supports a variety of operating systems and versions. This section describes the 
platforms that we ensure the engine runs on without issue (although in some cases with reduced 
functionality). 


Windows 
LiveCode supports the following versions of Windows: 


e Windows XP SP2 and above 

e Windows Server 2003 

e Windows Vista SP1 and above (both 32-bit and 64-bit) 
e Windows 7 (both 32-bit and 64-bit) 

e Windows Server 2008 

e Windows 8.x (Desktop) 

e Windows 10 
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Note: On 64-bit Windows installations, LiveCode runs as a 32-bit application through the WoW 
layer. 


Linux 
LiveCode supports Linux installations which meet the following requirements: 
e Supported CPU architectures: 
0 32-bit or 64-bit Intel/AMD or compatible processor 
e Required dependencies for core functionality: 
o glibc 2.13 or later 
e Optional requirements for GUI functionality: 


© GTK/GDK/Glib 2.24 or later 

o Pango with Xft support 

° esd (optional, needed for audio output) 

o mplayer (optional, needed for media player functionality) 

© Icms (optional, required for color profile support in images) 
© gksu (optional, required for privilege elevation support) 


Note: If the optional requirements are not present then LiveCode will still run but the specified 
features will be disabled. 


Note: The requirements for GUI functionality are also required by Firefox and Chrome, so if your 
Linux distribution runs one of those, it will run LiveCode. 


Note: It may be possible to compile and run LiveCode Community for Linux on other 
architectures but this is not officially supported. 


Mac 
The Mac engine supports: 


e 10.6.x (Snow Leopard) on Intel 
e 10.7.x (Lion) on Intel 

e 10.8.x (Mountain Lion) on Intel 
e 10.9.x (Mavericks) on Intel 

e 10.10.x (Yosemite) on Intel 

e 10.11.x (El Capitan) on Intel 


IOS 
iOS deployment is possible when running LiveCode IDE on a Mac, and provided Xcode is installed 
and has been set in LiveCode Preferences (in the Mobile Support pane). 


Currently, the supported versions of Xcode are: 


e Xcode 4.6 on MacOS X 10.7 
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e Xcode 5.1 on MacOS X 10.8 

e Xcode 6.2 on MacOS X 10.9 

e Xcode 6.2 and 7.2 on Mac OS X 10.10 
e Xcode 7.3 on MacOS X 10.11 


It is also possible to set other versions of Xcode, to allow testing on a wider range of iOS 
simulators. For instance, on Yosemite, you can add Xcode 5.1 in the Mobile Support preferences, 
to let you test your stack on the /OS Simulator 7.1. 


We currently support the following iOS Simulators: 


e 6.1 
e 7.1 
e 8.2 
e 9.2 
e 9.3 


Android 


LiveCode allows you to save your stack as an Android application, and also to deploy it on an 
Android device or simulator from the IDE. 


Android deployment is possible from Windows, Linux and Mac OSX. 


To enable deployment to Android devices, you need to download the Android SDK, and then use 
the 'Android SDK Manager' to install: 


e the latest "Android SDK Tools" 
e the latest "Android SDK Platform Tools" 


You also need to install the Java Development Kit (JDK). On Linux, this usually packaged as 
"openjdk". LiveCode requires JDK version 1.6 or later. 


Once you have set the path of your Android SDK in the "Mobile Support" section of the LiveCode 
IDE's preferences, you can deploy your stack to Android devices. 


Some users have reported successful Android Watch deployment, but it is not yet officially 
Supported. 


HTML5 


LiveCode applications can be deployed to run in a web browser, by running the LiveCode engine in 
JavaScript and using modern HTMLS5 JavaScript APIs. 


HTML5 deployment does not require any additional development tools to be installed. 


LiveCode HTML5 standalone applications are currently supported for running in recent versions of 
Mozilla Firefox, Google Chrome or Safari. For more information, please see the "HTML5 
Deployment" guide in the LiveCode IDE. 
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Installation 


Each version of LiveCode installs can be installed to its own, separate folder. This allow multiple 
versions of LiveCode to be installed side-by-side. On Windows (and Linux), each version of 
LiveCode has its own Start Menu (or application menu) entry. On Mac OS X, each version has its 
own app bundle. 


On Mac OS X, install LiveCode by mounting the .dmg file and dragging the app bundle to the 
Applications folder (or any other suitable location). 


For Windows and Linux, the default installation locations when installing for "All Users" are: 


Platform Path 
Windows <x86 program files folder>/RunRev/LiveCode <version> 


Linux /opt/livecode/livecode-<version> 


The installations when installing for "This User" are: 


Platform Path 
i RunR ts/Li 
Windwne <user roaming app data folder>/RunRev/Components/LiveCode 
<version> 
Linux ~/.runrev/components/livecode-<version> 


Note: If installing for "All Users" on Linux, either the gksu tool must be available, or you must 
manually run the LiveCode installer executable as root (e.g. using sudo or su). 


Uninstallation 


On Windows, the installer hooks into the standard Windows uninstall mechanism. This is accessible 
from the "Add or Remove Programs" applet in the windows Control Panel. 


On Mac OS X, drag the app bundle to the Trash. 


On Linux, LiveCode can be removed using the setup.x86 or setup.x86 64 program located in 
LiveCode's installation directory. 


Reporting installer issues 


If you find that the installer fails to work for you then please report it using the LiveCode Quality 
Control Centre or by emailing support@livecode.com. 


Please include the following information in your report: 


e Your platform and operating system version 

e The location of your home or user folder 

e The type of user account you are using (guest, restricted, admin etc.) 
e The installer log file. 


The installer log file can be located as follows: 
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Platform Path 


Windows 2000/XP <documents and settings folder>/<user>/Local Settings/ 
Windows Vista/7 <users folder>/<user>/AppData/Local/RunRev/Logs 


Linux <home>/.runrev/logs 


Activating LiveCode Indy or Business edition 


The licensing system ties your product licenses to a customer account system, meaning that you 
no longer have to worry about finding a license key after installing a new copy of LiveCode. 
Instead, you simply have to enter your email address and password that has been registered with 
our customer account system and your license key will be retrieved automatically. 


Alternatively it is possible to activate the product via the use of a specially encrypted license file. 
These will be available for download from the customer center after logging into your account. This 
method will allow the product to be installed on machines that do not have access to the internet. 


Command-line installation 


It is possible to invoke the installer from the command-line on Linux and Windows. When doing 
command-line installation, no GUI will be displayed. The installation process is controlled by 
arguments passed to the installer. 


Run the installer using a command in the form: 


<installer> install noui [OPTION ...] 


where <installer> should be replaced with the path of the installer executable or app (inside 
the DMG) that has been downloaded. The result of the installation operation will be written to the 
console. 


The installer understands any of the following OPTIONs: 


Option Description 
Install the IDE for "All Users". If not specified, LiveCode will be installed 
-allusers 
for the current user only. 
} ktop (Wi -onl 
Beeronenanecie Place a shortcut on the Desktop (Windows-only) 
-startmenu Place shortcuts in the Start Menu (Windows-only) 
-location The folder to install into. If not specified, the LOCATION defaults to those 
LOCATION described in the "Installation" section above. 
Snes woes us The file to which to log installation actions. If not specified, no log is 
generated. 


Note: the command-line installer does not do any authentication. When installing for "All Users", 
you will need to run the installer command as an administrator. 
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As the installer is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


start /wait <installer> install noui [OPTION ...] 


Command-line uninstallation 


It is possible to uninstall LiveCode from the command-line on Windows and Linux. When doing 
command-line uninstallation, no GUI will be displayed. 


Run the uninstaller using a command of the form: 
<uninstaller> uninstall noui 


Where is .setup.exe on Windows, and .setup.x86 on Linux. This executable, for both of the 
platforms, is located in the folder where LiveCode is installed. 


The result of the uninstallation operation will be written to the console. 


Note: the command-line uninstaller does not do any authentication. When removing a version of 
LiveCode installed for "All Users", you will need to run the uninstaller command as an 
administrator. 


Command-line activation for LiveCode Indy or Business edition 


It is possible to activate an installation of LiveCode for all users by using the command-line. When 
performing command-line activation, no GUI is displayed. Activation is controlled by passing 
command-line arguments to LiveCode. 


Activate LiveCode using a command of the form: 


<livecode> activate -file LICENSEFILE -passphrase SECRET 


where <Livecode> should be replaced with the path to the LiveCode executable or app that has 
been previously installed. 


This loads license information from the manual activation file LICENSEFILE, decrypts it using the 
given SECRET passphrase, and installs a license file for all users of the computer. Manual 


activation files can be downloaded from the My Products page in the LiveCode account 
management site. 


It is also possible to deactivate LiveCode with: 


<livecode> deactivate 
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Since LiveCode is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


start /wait <livecode> activate -file LICENSE -passphrase SECRET 
start /wait <livecode> deactivate 


On Mac OS X, you need to do: 


<livecode>/Contents/MacOS/LiveCode activate -file LICENSE -passphrase SECRET 
<livecode>/Contents/MacOS/LiveCode deactivate 
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Specific engine bug fixes (8.0.2-rc-4) 


17953 Fix regression to Mac window moveStack handling 

17962 Ensure the defaultStack hasn't been deleted before resetting it 

17981 Fix regression on retained external object reference 

Ensure mergExt externals that don't support mobile platforms don't include a Icext 
file 

18093 Fix a heap corruption issue due to an incompletely cleared object proxy. 


18090 


Specific engine bug fixes (8.0.2-rc-3) 


15366 Correctly update stack rectangle when moving to a different screen 
17571 Fix PDF display in CEF-based browser widget (Windows, Linux) 
17615 Fix crash when printing preview of card with browser widget on OSX 
17620 Fix javascript handlers of browser widget not callable on Android 
17720 Document MetaCard compatible pattern numbers 

17725 Add support for pattern numbers to backdrop 

17800 Ensure all parameters are included when using send script 

17802 Document howto escape special characters in wildcard filter patterns 
17839 Corrected mistaken key name in Info.plist file on iOS standalone 
8212 Correct mapping of pattern number to image id 

9778 _ Fix 'cut tVar' where tVar contains an object text chunk 


Specific engine bug fixes (8.0.2-rc-1) 


12953 Last character of dragdata["files"] is no longer cut off 


14790 
17330 
17366 
17384 
17468 
17578 
17590 
17624 
17652 
17666 
17695 
17731 
17733 
17737 
17738 
3263 
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Ensure modal color dialog blocks menus and shutdown requests 
Correct error in revLibURL's default HTTP headers 
LCPostOnMaintThread fails from aux thread in external on Android 
Fix issues with clipboard data property docs 

Fix crash when deleting the target object in a front or back script. 
List of patterns over indented in docs 

Insert item into a field line beyond range correctly 

Fix crash on Android in the files and folders functions 

Fix 'delete tVar' where tVar contains an object text chunk 

Fix crash when getting the effective leftIndent/rightIndent/firstIndent 
Improve "highlight" glossary entry 

Prevent anomalies when revert used in html5 standalone building 
Make sure borderColor of line chunk returns borderColor 

Screen should be force unlocked after resizeStack message is sent 
Fix potential crash on startup on Mac 

Fix drag select of grouped controls outside clipped rect 


IDE Changes —“C:SCSC‘CSCtiés 


Specific IDE bug fixes (8.0.2-rc-2) 


17769 


Ordering stacks by chosen preference in project browser 


Specific IDE bug fixes (8.0.2-rc-1) 


14003 


17414 
17417 
17441 
17450 
17470 
17566 
17638 
17669 


17727 


17735 
17742 


Make sure enabling a palette from the menubar does actually show the palette, in 
case it is hidden 

Placed Groups are no longer incorrectly deleted via dialog 

Update value of variables in visualizers when stepping through script 

Ensure revSelectedObjectChanged is sent to plugins 

Ensure check marks in project browser match selected preference 

Ensure arrowKey messages are passed to user stacks in browse mode 

BMI tutorial- Correct key combination when setting header title 

Window menu now shows stack names instead of stack titles 

BMI tutorial- Header widget script should contain cWeight instead of cWidth 
Make it possible to launch the PDF version of the User Guide from the Resource 
Center 

Application browser now responds correctly to various events 

Selecting browse tool should exit edit group mode 


LiveCode extension changes 


Line Graph widget 


10 


LiveCode 8.0.2 Release Notes 8/9/16 


Properties 


e Throw an error when the graphData property is set to an invalid value, such as an empty 
string. 


Specific extension bug fixes (8.0.2-rc-3) 


17373 enable setting local timezone, make local default 


Specific extension bug fixes (8.0.2-rc-1) 


17692 Prevent errors in onPaint with empty graphData 
Make sure the mouseAction is properly updated when clicking on the headerbar 


17790 widget 


DictOnarv additions 


e documentFilename (property) has been added to the dictionary. 
e fullClipboard Data (property) has been added to the dictionary. 
e newWidget (message) has been added to the dictionary. 

e rawClipboard Data (property) has been added to the dictionary. 
e scriptOnly (property) has been added to the dictionary. 

e widget (object) has been added to the dictionary. 
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